home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtOpenApplication.z / XtOpenApplication
Encoding:
Text File  |  2002-10-03  |  7.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttOOOOppppeeeennnnAAAApppppppplllliiiiccccaaaattttiiiioooonnnn((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttOOOOppppeeeennnnAAAApppppppplllliiiiccccaaaattttiiiioooonnnn((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtOpenApplication, XtVaOpenApplication - initialize, open,
  10.           or close a display
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Widget XtOpenApplication(_a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n,
  14.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s, _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c__i_n__o_u_t,
  15.           _a_r_g_v__i_n__o_u_t, _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s, _w_i_d_g_e_t__c_l_a_s_s, _a_r_g_s,
  16.           _n_u_m__a_r_g_s)
  17.                 XtAppContext* _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n;
  18.                 String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  19.                 XrmOptionDescRec* _o_p_t_i_o_n_s;
  20.                 Cardinal _n_u_m__o_p_t_i_o_n_s;
  21.                 int* _a_r_g_c__i_n__o_u_t;
  22.                 String* _a_r_g_v__i_n__o_u_t;
  23.                 String* _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s;
  24.                 WidgetClass _w_i_d_g_e_t__c_l_a_s_s;
  25.                 ArgList _a_r_g_s;
  26.                 Cardinal _n_u_m__a_r_g_s;
  27.  
  28.           Widget XtVaOpenApplication(_a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n,
  29.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s, _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c__i_n__o_u_t,
  30.           _a_r_g_v__i_n__o_u_t, _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s, _w_i_d_g_e_t__c_l_a_s_s, ...)
  31.                 XtAppContext* _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n;
  32.                 String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  33.                 XrmOptionDescRec* _o_p_t_i_o_n_s;
  34.                 Cardinal _n_u_m__o_p_t_i_o_n_s;
  35.                 int* _a_r_g_c__i_n__o_u_t;
  36.                 String* _a_r_g_v__i_n__o_u_t;
  37.                 String* _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s;
  38.                 WidgetClass _w_i_d_g_e_t__c_l_a_s_s;
  39.  
  40.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  41.           _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n
  42.                     Specifies the application context.
  43.  
  44.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s
  45.                     Specifies the class name of this application,
  46.                     which usually is the generic name for all
  47.                     instances of this application.
  48.  
  49.           _o_p_t_i_o_n_s   Specifies how to parse the command line for any
  50.                     application-specific resources.  The options
  51.                     argument is passed as a parameter to
  52.                     _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d.  For further information, see
  53.                     _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.
  54.  
  55.           _n_u_m__o_p_t_i_o_n_s
  56.                     Specifies the number of entries in the options
  57.                     list.
  58.  
  59.           _a_r_g_c__i_n__o_u_t
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttOOOOppppeeeennnnAAAApppppppplllliiiiccccaaaattttiiiioooonnnn((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttOOOOppppeeeennnnAAAApppppppplllliiiiccccaaaattttiiiioooonnnn((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.                     Specifies a pointer to the number of command line
  75.                     parameters.
  76.  
  77.           _a_r_g_v__i_n__o_u_t
  78.                     Specifies the command line parameters.
  79.  
  80.           _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s
  81.                     Specifies resource values to be used if the
  82.                     application class resource file cannot be opened
  83.                     or read, or NULL.
  84.  
  85.           _w_i_d_g_e_t__c_l_a_s_s
  86.                     Specifies the widget class of the shell to be
  87.                     created.
  88.  
  89.           _a_r_g_s      Specifies the argument list to override any other
  90.                     resource specification for the created shell
  91.                     widget.
  92.  
  93.           _n_u_m__a_r_g_s  Specifies the number of entries in the argument
  94.                     list.
  95.  
  96.           ...       Specifies the variable argument list to override
  97.                     any other resource specification for the created
  98.                     shell widget.
  99.  
  100.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  101.           The _X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n function calls _X_t_T_o_o_l_k_i_t_I_n_i_t_i_a_l_i_z_e
  102.           followed by _X_t_C_r_e_a_t_e_A_p_p_l_i_c_a_t_i_o_n_C_o_n_t_e_x_t, then calls
  103.           _X_t_O_p_e_n_D_i_s_p_l_a_y with _d_i_s_p_l_a_y__s_t_r_i_n_g NULL and _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e
  104.           NULL, and finally calls _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l with _a_p_p_c_a_t_i_o_n__n_a_m_e
  105.           NULL, _w_i_d_g_e_t__c_l_a_s_s _a_p_p_l_i_c_a_t_i_o_n_S_h_e_l_l_W_i_d_g_e_t_C_l_a_s_s, and the
  106.           specified _a_r_g_s and _n_u_m__a_r_g_s and returns the created shell.
  107.           The modified _a_r_g_c and _a_r_g_v returned by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e
  108.           are returned in _a_r_g_c__i_n__o_u_t and _a_r_g_v__i_n__o_u_t. If
  109.           _a_p_p__c_o_n_t_e_x_t__r_e_t_u_r_n _i_s _n_o_t _N_U_L_L, _t_h_e _c_r_e_a_t_e_d _a_p_p_l_i_c_a_t_i_o_n
  110.           _c_o_n_t_e_x_t _i_s _a_l_s_o _r_e_t_u_r_n_e_d. _I_f _t_h_e _d_i_s_p_l_a_y _s_p_e_c_i_f_i_e_d _b_y _t_h_e
  111.           _c_o_m_m_a_n_d _l_i_n_e _c_a_n_n_o_t _b_e _o_p_e_n_e_d, _a_n _e_r_r_o_r _m_e_s_s_a_g_e _i_s _i_s_s_u_e_d
  112.           _a_n_d _X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n _t_e_r_m_i_n_a_t_e_s _t_h_e _a_p_p_l_i_c_a_t_i_o_n. _I_f
  113.           _f_a_l_l_b_a_c_k__r_e_s_o_u_r_c_e_s _i_s _n_o_n-_N_U_L_L, _X_t_A_p_p_S_e_t_F_a_l_l_b_a_c_k_R_e_s_o_u_r_c_e_s _i_s
  114.           _c_a_l_l_e_d _w_i_t_h _t_h_e _v_a_l_u_e _p_r_i_o_r _t_o _c_a_l_l_i_n_g _X_t_O_p_e_n_D_i_s_p_l_a_y.
  115.  
  116.           XtAppInitialize and XtVaAppInitialize have been superceded
  117.           by _X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n and _X_t_V_a_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n respectively.
  118.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  119.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.